home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / raqmx130.zip / RAQMX130.DOC < prev    next >
Text File  |  1990-07-04  |  36KB  |  733 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.          ┌───────────┐         ┌───────────┐             ┌───┐     ┌───┐
  20.          │▒▒▒▒▒▒▒▒▒▒ ├─────────┴┐▒▒▒▒▒▒▒▒▒ ├─────────────┴┐▒ └┐   ┌┘▒▒ │
  21.          │▒▒┌────┐▒▒ │▒▒▒▒▒▒▒▒▒ │▒▒┌────┐▒ │▒▒▒▒▒▒▒▒▒▒▒▒▒ │▒▒ └┐ ┌┘▒▒ ┌┘
  22.          │▒▒└────┘▒┌─┘▒┌─────┐▒ │▒▒│    │▒ │▒ ┌──┐▒┌──┐▒▒ ├┐▒▒ └─┘▒▒ ┌┘
  23.          │▒▒▒▒▒▒▒▒▒└─┐▒└─────┘▒ │▒▒│    │▒ │▒ │  │▒│  │▒▒ ├┘▒▒ ┌─┐▒▒ └┐
  24.          │▒▒▒┌───┐▒▒ │▒▒▒▒▒▒▒▒▒ │▒▒│    │▒ │▒ │  │▒│  │▒▒ │▒▒ ┌┘ └┐▒▒ └┐
  25.          │▒▒▒│   │▒▒ │▒▒┌───┐▒▒ │▒▒└────┘▒ └┐ │  └─┘  │▒▒ │▒ ┌┘   └┐▒▒ │
  26.          │▒▒▒│   │▒▒ │▒▒│   │▒▒ │▒▒▒▒▒▒▒▒▒▒ └┐│       │▒▒ │▒ │     │▒▒ │
  27.          └───┘   └──┬┘▒▒│   │▒▒ ├─────────┬──┘│       │▒▒ ├──┘     └───┘
  28.                     └───┘   └───┘         └───┘       └───┘
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                      RemoteAccess/QuickBBS Message Express
  38.                                   Version 1.30
  39.                 Program CopyRight (C) 1989, 1990 by Mike Ratledge
  40.       Documentation written and all rights reserved by Ed Meloan of 360/1
  41.  
  42. ┌─────────────────────────────────────────────────────────────────────────────┐
  43. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 1   ▒▒▒ │
  44. └─────────────────────────────────────────────────────────────────────────────┘
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.             ┌─────────────────────────────────────────────────────┐
  52.             │  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒  Table of Contents ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  │
  53.             └─────────────────────────────────────────────────────┘
  54.  
  55.  
  56.  
  57.  
  58.                 What is RAQMX ............................... 2
  59.                 
  60.                 Getting Started ............................. 3
  61.  
  62.                 Setting Up RAQMX for QuickBBS ............... 4
  63.  
  64.                 Setting Up RAQMX for RemoteAccess ........... 5
  65.  
  66.                 Processing INBOUND Mail ..................... 7
  67.  
  68.                 Setting Up The QMXSETUP.CFG File ............ 8
  69.  
  70.                 A Few Hints ................................. 10
  71.  
  72.                 A Short Check List .......................... 11
  73.  
  74.                 Using RAQMX on Your BBS ..................... 11
  75.  
  76.                 Odds & Ends ................................. 13
  77.  
  78.                 Credits ..................................... 15
  79.  
  80. ┌─────────────────────────────────────────────────────────────────────────────┐
  81. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 2   ▒▒▒ │
  82. └─────────────────────────────────────────────────────────────────────────────┘
  83.  
  84.  
  85.  
  86.  
  87.  
  88.                          ┌─────────────────────────┐
  89.                          │ ▒▒▒  What is RAQMX  ▒▒▒ │
  90.                          └─────────────────────────┘
  91.  
  92.  
  93.  
  94.  
  95. RAQMX is An exciting way for your callers to get all the messages they are 
  96. interested in and =READ THEM AFTER THEY LOG OFF=.  The  RAQMX system allows 
  97. your users to do the following: 
  98.  
  99.          1.  Custom select the Message Areas =THEY= want to read
  100.  
  101.          2.  Collect the new messages from these areas =AND= ALL
  102.              messages addressed to them even in areas they don't select.
  103.  
  104.          3.  Pack them in an archive and send them to their computer
  105.  
  106.          4.  Lets your user read them while off-line, freeing your board
  107.              for the next caller!!
  108.  
  109.          5.  The companion XRS Response system gives your caller an
  110.              EXCELLENT full-screen editor that allows them to read,
  111.              reply and edit all their messages WHILE OFF-LINE!
  112.  
  113.          6.  Pack their replies and send them back to this BBS where
  114.              RAQMX will automatically place them in the correct message
  115.              areas just as if the user had written them there.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127. ┌─────────────────────────────────────────────────────────────────────────────┐
  128. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 3   ▒▒▒ │
  129. └─────────────────────────────────────────────────────────────────────────────┘
  130.  
  131.  
  132.  
  133.  
  134.             ┌─────────────────────────────────────────────────────┐
  135.             │  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  Getting Started  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  │
  136.             └─────────────────────────────────────────────────────┘
  137.  
  138.  
  139.  
  140. Read the following information and you'll be on your way to providing your 
  141. RemoteAccess/QuickBBS users with this exciting new feature!
  142.  
  143. If you're already running ECHOMAIL - then you are well on your way already!
  144. Since RAQMX depends on an AREAS.BBS file to know where to place incoming 
  145. messages, you'll need to have that file set up.  One point here is that you 
  146. =MUST= setup names for EVERY message area...  Even ones which normally do not 
  147. handle ECHOMAIL.  This allows your present echomail processing to properly toss
  148. LOCAL as well as ECHO messages into the correct message areas.
  149.  
  150. [A note here that while RAQMX can handle AREAS.BBS area names in lower case, 
  151. some mail tossers can not!  All area names should be in UPPER CASE.] 
  152.  
  153. The XRS program requires group zero to be a local message area, and therefore 
  154. XRS always shows "00 LOCAL" as the first available group.  This 00 area is 
  155. inherited from the TCOMM program, for which XRS was originally written, and 
  156. really has no function in the QuickBBS environment.  You should setup the main 
  157. general local area of your BBS with the area name "LOCAL", so that the mail 
  158. tosser will place the inbound traffic into the correct area.  This can be ANY 
  159. message area number as long as it is named LOCAL in AREAS.BBS. Since there is 
  160. no 00 area, as there is in TCOMM, you will want to use one of your regular 
  161. area numbers.  This feature is required because all your users may not have 
  162. access to NetMail - they cannot send private message back to your BBS (XRS 
  163. will =ONLY= allow private status on NetMail, Local or in response to a private 
  164. message)!
  165.  
  166. ┌─────────────────────────────────────────────────────────────────────────────┐
  167. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 4   ▒▒▒ │
  168. └─────────────────────────────────────────────────────────────────────────────┘
  169.          ┌────────────────────────────────────────────────────┐
  170.          │  ▒▒▒▒▒▒▒   Setting Up RAQMX for QuickBBS  ▒▒▒▒▒▒▒  │
  171.          └────────────────────────────────────────────────────┘
  172.  
  173. RAQMX is compiled in TWO versions.  Select RAQMX.EXE for use on XT (8088/8086) 
  174. systems and RAQMX286.EXE for V20/80286/80386 systems and place the correct 
  175. version in your QuickBBS system directory.
  176.  
  177. RAQMX must be set up as a Type 15 external program.  It will NOT work as a 
  178. type 7 option.  Here are the steps to set RAQMX up as a type 15 menu option: 
  179.  
  180. Decide on an error level and add the following lines to your QuickBBS or 
  181. Mailer BAT file.  Let's assume we decide to use 98 as our level.  We would set 
  182. up a type 15 menu option with 98 as the optional data.  Do not type the 
  183. comments that are in brackets.
  184.  
  185. :After_Quick
  186.    If errorlevel 98 goto RAQMX    (ADD this line)
  187.    If errorlevel 5 goto Both      (You probably already have this line)
  188.    If errorlevel 4 goto NewEcho   ( "     "        "     "     "    " )
  189.    If errorlevel 3 goto NewNet    ( "     "        "     "     "    " )
  190.    Goto Loop  (or whatever you call your starting section of BAT file)
  191.  
  192.  
  193. Since RAQMX has its own internal FOSSIL handling and carrier detection, you 
  194. will not need nor should you use redirection devices such as CTTY or GATEWAY 
  195. or carrier monitors such as WATCHCD.  Please =DO NOT= use them.  All you will 
  196. need in your BAT file will be something like this: 
  197.  
  198. :RAQMX
  199.    RAQMX286 (or RAQMX.EXE)
  200.    QuickBBS -R -E0
  201.    Goto After_Quick
  202.  
  203.        ┌─────────────────────────────────────────────────────────────┐
  204.        │  ▒▒▒▒▒▒▒▒▒         TWO IMPORTANT NOTES !!        ▒▒▒▒▒▒▒▒▒  │
  205.        └─────────────────────────────────────────────────────────────┘
  206.  
  207. You =MUST= have the popular archiving programs PKARC, PKZIP, and LHARC as well 
  208. as a recent version of ZMODEM AVAILABLE IN YOUR PATH STATEMENT!!  We cannot 
  209. emphasize this too strongly.  Having them in the QuickBBS sub-directory is not 
  210. necessarily enough if you don't have that sub-dir in the path statement!
  211.  
  212. RAQMX uses DSZ.COM to provide external protocol support.  It does not select 
  213. the COM: port for DSZ!  If you use COM2: (or anything other than the default 
  214. COM1: address) you must place the following command immediately before RAQMX 
  215. in your batch file: SET DSZPORT=2 
  216.  
  217. SET DSZPORT=2 would tell DSZ to use COM2:, for example.  You should also place 
  218. a similar command after RAQMX without the '2' (but no spaces after the '=' 
  219. either!), and you will free up the environment string space it uses. 
  220.  
  221. ┌─────────────────────────────────────────────────────────────────────────────┐
  222. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 5   ▒▒▒ │
  223. └─────────────────────────────────────────────────────────────────────────────┘
  224.  
  225.  
  226.        ┌─────────────────────────────────────────────────────────────┐
  227.        │  ▒▒▒▒▒▒▒▒▒   Setting Up RAQMX for RemoteAccess   ▒▒▒▒▒▒▒▒▒  │
  228.        └─────────────────────────────────────────────────────────────┘
  229.  
  230.  
  231.  
  232. RAQMX is compiled in TWO versions.  Select RAQMX.EXE for use on XT (8088/8086) 
  233. systems and RAQMX286.EXE for V20/80286/80386 systems and place the correct 
  234. version in your RA system directory. If running more than one line, place a 
  235. copy in EACH line's directory (\RA\LINEx) as discussed below...
  236.  
  237. Complete file sharing and record-locking for updates is enabled *if* DOS 
  238. "Share" is detected.  Assuming Share *is* detected, RAQMX looks for "TCNODE" in 
  239. the DOS environment to determine the node number the user is on (i.e. "SET 
  240. TCNODE=2" for node 2, etc), and then uses BAT2MAIL.XRS, MAIL2IDX.XRS, 
  241. SUMMARY2.XRS, USER2.XRS & AREAS2.XRS, all of which get archived into the file 
  242. BAT2MAIL.* unless it's a local SysOp logon and SysOpOut is in affect.
  243.  
  244. If you run multi-line RemoteAccess, you *must* start the program from the 
  245. proper \RA\LINEx (or whatever you call them) sub-directory.  It is NOT 
  246. necessary to duplicate the files used by RAQMX in each line's directory.  
  247. Here's why... 
  248.  
  249. RAQMX checks for the "RA" set in the DOS environment, and if found, looks in 
  250. that subdirectory for the CONFIG.RA file.  Assuming "RA" is set, RAQMX uses 
  251. that file plus the MESSAGES.RA. It then uses the path found in CONFIG.RA to 
  252. find the message databases.
  253.  
  254. The following files are looked for in the current sub-dir, then in the System 
  255. Path and finally in the Messages Path. 
  256.  
  257. QMXSETUP.CFG, USERS.BBS, EXPRESS.BBS and FLSEARCH.QMX
  258.  
  259. You can have specialized nodes or let a single set of control files be used.
  260. The "QMX_CONF.SYS" file (user defaults) is first looked for in the current
  261. sub-directory, then in the System (*not* messages!) sub-directory for RA.
  262. This way you can have separate paremeters/configuations and users on each
  263. node if you wish, or one configuration stored in the System directory.
  264.  
  265. RAQMX will look for DORINFO1.DEF and EXITINFO.BBS in the sub-directory where 
  266. RAQMX is located and =ASSUMES NODE 1= so single-line systems with Share 
  267. enabled are not treated like networks and the use of the TCNODE environment 
  268. variable is only required for true multi-line systems. 
  269.  
  270. ┌─────────────────────────────────────────────────────────────────────────────┐
  271. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 6   ▒▒▒ │
  272. └─────────────────────────────────────────────────────────────────────────────┘
  273.  
  274.  
  275. Using file sharing and record-locking, multiple users can all access the 
  276. databases =AND= RAQMX at the same time.  Full support for the "RemoteAccess 
  277. BBS" software is included.  RAQMX looks to see if RA has been set in the 
  278. environment and if found, uses the RA Configuration files for information 
  279. about message area security and access. It also notifies XRS 3.12 and later to 
  280. tag the tear and origin lines with the proper RAX identity.  Please NOTE that 
  281. although RAQMX uses the MESSAGE.RA file, it will still need an AREAS.BBS file 
  282. since the MESSAGE.RA file does =NOT= contain the exact ECHOMAIL AREA NAMES!
  283. You do not need a copy of AREAS.BBS in each line's sub-directory since RAQMX 
  284. will look in the system and message directories if it doesn't find the file in 
  285. the current one. 
  286.  
  287. RAQMX is remarkably simple to setup on the RemoteAccess system.  A menu type 7 
  288. (shell) works VERY well!  Add the *M and you can swap RA out of memory if you 
  289. are multitasking and memory space is limited.
  290.            
  291. Since RAQMX has its own internal FOSSIL handling and carrier detection, you 
  292. will not need nor should you use redirection devices such as CTTY or GATEWAY 
  293. or carrier monitors such as WATCHCD.  Please =DO NOT= use them.  All you will 
  294. need in your menu type 7 OPTIONAL DATA is the following line:
  295.  
  296.    C:\RA\RAQMX286 *M (or RAQMX.EXE *M)
  297.  
  298. That's it!  No elaborate BAT files are needed!  Including the C:\RA\ path 
  299. will allow you to use a single copy of the RAQMX program, regardless of the
  300. number of lines you may be running.  If you do NOT include the path, you will 
  301. need a copy of RAQMX in the directory for EACH line.
  302.  
  303.  
  304.        ┌─────────────────────────────────────────────────────────────┐
  305.        │  ▒▒▒▒▒▒▒▒▒         TWO IMPORTANT NOTES !!        ▒▒▒▒▒▒▒▒▒  │
  306.        └─────────────────────────────────────────────────────────────┘
  307.  
  308. You =MUST= have the popular archiving programs PKARC, PKZIP, and LHARC as well 
  309. as a recent version of ZMODEM AVAILABLE IN YOUR PATH STATEMENT!!  We cannot 
  310. emphasize this too strongly.  Having them in the sub-directory with RAQMX is 
  311. not necessarily enough if you don't have that sub-dir in the path statement! 
  312.  
  313. RAQMX uses DSZ.COM to provide external protocol support.  It does not select 
  314. the COM: port for DSZ!  If you use COM2: (or anything other than the default 
  315. COM1: address) you must place the following command immediately before RAQMX 
  316. in your batch file: SET DSZPORT=2 
  317.  
  318. SET DSZPORT=2 would tell DSZ to use COM2:, for example.  You should also place 
  319. a similar command after RAQMX without the '2' (but no spaces after the '=' 
  320. either!), and you will free up the environment string space it uses.   
  321.  
  322. ┌─────────────────────────────────────────────────────────────────────────────┐
  323. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 7   ▒▒▒ │
  324. └─────────────────────────────────────────────────────────────────────────────┘
  325.        ┌─────────────────────────────────────────────────────────────┐
  326.        │  ▒▒▒▒▒▒▒▒▒         Processing INBOUND Mail       ▒▒▒▒▒▒▒▒▒  │
  327.        └─────────────────────────────────────────────────────────────┘
  328.  
  329. RAQMX IS HARD-CODED TO PUT UPLOADED FILES INTO A NEW SUB-DIRECTORY NAMED \QMX 
  330. ON THE CURRENT DRIVE.  You will need to MAKE A DIRECTORY, off the root, called 
  331. QMX.  You must move the incoming message files, from your users, into your 
  332. normal inbound net files area for processing by your echomail software.  To do 
  333. this automatically, you'll need to add the following lines to your BAT file to 
  334. handle the incoming mail.  Place this line so that it is read either before or 
  335. after every call! 
  336.    If exist \QMX\xxxx????.* goto QmxMail
  337.                  ^^^^
  338. (Note: this number will always be the same for your system, but it will *not*
  339.  actually be "xxxx" - for example, "73E3" is the number XRS will use if you
  340.  are in net 360.  It is computed exactly like a normal FidoNet echomail bundle
  341.  name would be computed by subtracting net numbers - in hex, of course)
  342.  
  343. Now place the following lines IMMEDIATELY before (above) your section that 
  344. tosses incoming echomail.
  345.  
  346. :QmxMail
  347.    COPY \QMX\xxxx????.* \FD\FILES (Replace \FD\Files with YOUR incoming
  348.    DEL \QMX\xxxx????.*             mail directory)
  349.  
  350.  
  351. :Toss_Echo  (Start of your regular ECHO tossing section)
  352.    CD\RA (or QuickBBS or FD)
  353.    Qecho -A -P -T -U   (or EchoGen, TosScan or Zmail...)
  354.    Goto Loop
  355.  
  356. This will copy the new incoming messages into the correct area and then drop 
  357. through to your regular tossing program.
  358.  
  359. RAQMX exits with different errorlevels to tell you whether an upload was
  360. received and/or mail was downloaded.  ErrorLevel = 0 means no errors and
  361. neither u/l or d/l was used.  ErrorLevel 1 means mail was downloaded, a 2
  362. means mail was uploaded and a 3 means both upload and download of mail.
  363.  
  364. An option is available which allows the user to get their mail, automatically 
  365. update their "last read" pointer and automatically LOG OFF!  Three additional 
  366. error levels handle this "auto-logoff" function for those who wish to control 
  367. mail handling through error codes.  4 indicates automatic logoff (no 
  368. download), 5 indicates auto-logoff with a mailbag downloaded and 6 means auto-
  369. logoff with both upload and download of mail. (All higher exit codes indicate 
  370. other program failure of some type!) These error levels can be used to direct 
  371. specific BATCH file activities if desired.  Please note!  It is NOT necessary 
  372. to use these codes unless you wish to do so.  RemoteAccess or QuickBBS will 
  373. recover from the AUTO-LOGOFF without their use and mail will be tossed 
  374. normally. 
  375.  
  376. RAQMX uses SYSTEM.LOG (for QuickBBS) and the system log name found in 
  377. CONFIG.RA (for RemoteAccess). It will write log entries in the correct format 
  378. (QuickBBS, FrontDoor or Opus style). 
  379.  
  380. ┌─────────────────────────────────────────────────────────────────────────────┐
  381. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 8   ▒▒▒ │
  382. └─────────────────────────────────────────────────────────────────────────────┘
  383.  
  384.  
  385.        ┌────────────────────────────────────────────────────────────┐
  386.        │  ▒▒▒▒▒▒▒▒▒   Setting Up The QMXSETUP.CFG File   ▒▒▒▒▒▒▒▒▒  │
  387.        └────────────────────────────────────────────────────────────┘
  388.  
  389.  
  390. RAQMX allows the SysOp to control certain functions by editing a 
  391. "configuration" file.  This file is named: QMXSETUP.CFG.  Here are the 
  392. options in QMXSETUP.CFG along with brief descriptions of the options 
  393. function.
  394.  
  395. BBSID xxxxxxx - The "BBSID" parameter is =REQUIRED=! If not found, RAQMX will 
  396. still run, but it will beep and display a warning message and use the name 
  397. "UNKNOWN1" for the BBS name if "Named Mailbags" are turned on by the user.  
  398. You should set the BBSID parameter to something that will uniquely identify 
  399. your BBS.  For example, Augusta Forum is AGFORUM.  RAQMX will read ONLY the 
  400. first seven characters and will add the correct extension. If you are running 
  401. RemoteAccess and using multiple lines, the eighth character will indicate the 
  402. line the caller was using.  Note that this feature is only available to users 
  403. of XRS 3.21 and later, and it must be turned on in the new "Option Toggle" 
  404. section by any user that wants the "Named Mailbag" feature.  Named Mailbags 
  405. will be the default soon.  Earlier versions of QMX used BBSID to include a 
  406. file in the users mailbag.  This function is now handled by the INCLUDE option 
  407. which is explained on the next page.
  408.  
  409. NetMail xxx - =REQUIRED for RemoteAccess systems= Where 'xxx' is the area 
  410. number of the netmail board.  Failure to set this parameter for RA systems 
  411. causes RA/QMX to beep and use area # 201 as the netmail area (which doesn't 
  412. exist), therefore any netmail will be treated as echomail!  Not needed for 
  413. QuickBBS. 
  414.  
  415. InDir xxxxx - Allows you to give a different path for incoming mailbags 
  416. (default is "\QMX").  This is mostly to allow you to accept mail for multiple 
  417. nodes into separate areas if you also have the "Point xxx" parameter (which 
  418. causes everyone to have similar filenames). 
  419.  
  420. PointNet xxxxx - Allows you to select the point number used by XRS.  By 
  421. default, XRS uses pointnet number 30027, which was assigned to the program by 
  422. the ZC/IC. 
  423.  
  424. ShowBar - Forces the status bar to be shown even if Desqview is detected. 
  425.  
  426. NoBeep - Turns off beeps on SysOp side.
  427.  
  428. OutPath x:\path - Allows you to have RAQMX automatically place the resulting 
  429. BAT1MAIL.xxx archive file into a different subdirectory. The "X:\PATH" portion 
  430. *MUST* point to a directory name! (you can't change the final filename, 
  431. anyway).  You should DELETE this file automatically at logoff time to prevent 
  432. users from reading someone else's mail. 
  433.  
  434. ┌─────────────────────────────────────────────────────────────────────────────┐
  435. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 9   ▒▒▒ │
  436. └─────────────────────────────────────────────────────────────────────────────┘
  437.  
  438.  
  439.        ┌────────────────────────────────────────────────────────────┐
  440.        │  ▒▒▒▒▒▒▒▒▒ Continuing the Setup of QMXSETUP.CFG ▒▒▒▒▒▒▒▒▒  │
  441.        └────────────────────────────────────────────────────────────┘
  442.  
  443.  
  444. SysopOut x:\path -  Allows THE SYSOP (User 0) to have RAQMX automatically 
  445. place an UNARCHIVED MAILBAG into a different subdirectory.  The "X:\PATH" 
  446. portion *MUST* point to a directory name!
  447.  
  448. NoBuff -  Disable file buffering on MSGHDR.BBS and MSGTXT.BBS - on some 
  449. systems it may be faster to *not* buffer these files! 
  450.  
  451. LockBaud - Force Hardware Flow Control on DSZ - required for HST's, etc!
  452.  
  453. ShowFiles - Show New Uploads ON SCREEN during FileScan.  Files will ALWAYS be 
  454. included in the XRS <F6>Summary if FLEARCH.QMX is present.  More on 
  455. FLSEARCH.QMX later. 
  456.  
  457. NoBreak - To disable <CTRL-BREAK/C/K> exits from external batch files, you 
  458. may use the this parameter.  NOTE:  The user cannot interrupt the program 
  459. except by hanging up if this is turned on!  Under normal conditions, this 
  460. option should be left turned OFF!  (When left off, the user is sent back to 
  461. the BBS when he hits <CTRL-BREAK>...)
  462.  
  463. Point 666 - In order to run in "No Points" mode, or to assign a specific 
  464. point number to all RAQMX/XRS users, place a number from 0 up to 32767.
  465.  
  466. Limit 500 - To use a different maximum limit of messages for one mailbag, 
  467. assign any number less than 995.
  468.  
  469. Defer -  Disable the internal DSZ downloads (so user can d/l from normal 
  470. files area) [NOT NEEDED if OUTPATH is used] 
  471.  
  472. Include -  Accepts a filename (*with* pathname!) and inserts that file into 
  473. the mailbags. 
  474.  
  475. ┌─────────────────────────────────────────────────────────────────────────────┐
  476. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 10  ▒▒▒ │
  477. └─────────────────────────────────────────────────────────────────────────────┘
  478.  
  479.  
  480.  
  481.        ┌────────────────────────────────────────────────────────────────┐
  482.        │  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒          A Few Hints         ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  │
  483.        └────────────────────────────────────────────────────────────────┘
  484.  
  485.  
  486. RAQMX looks for FLSEARCH.QMX - if not found *NO* "New File Search" is done at 
  487. all!  This way you can just search one or two if that is what you want, or you 
  488. can turn it off altogether.  If you want it to search all areas, just "COPY 
  489. FLSEARCH.CTL FLSEARCH.QMX". (the format of the file is *exactly* like 
  490. FLSEARCH.CTL!)  If you do not want to search ALL areas, simply copy 
  491. FLSEARCH.CTL to FLSEARCH.QMX and then edit out the lists you do not want 
  492. included in the search. 
  493.  
  494. You can also automatically restrict the user-side program (XRS) from sending 
  495. any mailbags in formats you can't process by placing a file named ARC_ONLY.XRS 
  496. (or ZIP_ONLY.XRS, but not both!) into the system subdirectory.  When XRS 
  497. sees this file it will only use the desired method to pack the mail.  Note 
  498. that "SPAZ" is available in the archive and handles *any* compression type! 
  499.  
  500. You may also "Force" your users to use YOUR origin line if you like.  To do 
  501. this just create a file called XORIGIN.XRS which contains the desired line (in 
  502. plain ASCII).  If XORIGIN is present, RAQMX will place a CRC value in the users 
  503. file which can be read by XRS version 3.12 or later.  This CRC check will not 
  504. allow the user to replace YOUR line with one of his own.  A CRC check is also 
  505. performed on the users name.  If either are incorrect XRS will terminate 
  506. immediately. 
  507.  
  508. Normally, you (the SysOp) will be the first to try RAQMX and this will result 
  509. in you being RAQMX Point # 1.  Please =DO= make sure that you are point # 1 
  510. since this is the only point number that is allowed to send CRASH NetMail!
  511.  
  512.  
  513. ┌─────────────────────────────────────────────────────────────────────────────┐
  514. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 11  ▒▒▒ │
  515. └─────────────────────────────────────────────────────────────────────────────┘
  516.  
  517.  
  518.        ┌────────────────────────────────────────────────────────────────┐
  519.        │  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒     A Short Check List       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  │
  520.        └────────────────────────────────────────────────────────────────┘
  521.  
  522. Here's a short check list of what we have done.
  523.  
  524. 1.  Make sure ALL message areas are listed in AREAS.BBS
  525.  
  526. 2.  Create a directory called QMX OFF THE ROOT, not off the QuickBBS or RA 
  527.     subdirectory! 
  528.  
  529. 3.  Add a Menu option to allow your users to access RAQMX
  530.  
  531. 4.  If QuickBBS, add the necessary lines to your BAT file to handle a Type
  532.     15 menu option exit.  If RemoteAccess, add a type 7 menu option as shown
  533.     in the RA section.
  534.  
  535. 5.  Add the necessary lines to MOVE incoming RAQMX mail to your ECHO tossing
  536.     directory
  537.  
  538. 6.  Edit QMXSETUP.CFG and place it and RAQMX.EXE in the QuickBBS directory or
  539.     if running RA, place QMXSETUP in the RA system directory and place a copy
  540.     of RAQMX.EXE in each line's sub-directory.
  541.  
  542. 7.  Make a copy of FLSEARCH.CTL and name it FLSEARCH.QMX =IF= you want new
  543.     files listed.  Place it in the system directory.
  544.  
  545.  
  546.        ┌────────────────────────────────────────────────────────────────┐
  547.        │  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   Using RAQMX on YOUR BBS    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒  │
  548.        └────────────────────────────────────────────────────────────────┘
  549.  
  550.  
  551. Important!  Your caller MUST have a CONFIG.SYS file setup on their system 
  552. with a FILES equal AT LEAST 20!  Failure to do this will cause the XRS 
  553. program to be unable to unpack mail.  If a user complains about this problem, 
  554. that should be the first thing you ask about.  They should also download a 
  555. small mailbag BEFORE running XRS the first time.  XRS will look for mail and 
  556. complain if it can't locate any!  (this also can cause the program not to
  557. "see" other files that *are* there...)
  558.  
  559. Your callers will find running RAQMX to be basically intuitive.  The first time 
  560. your user goes into RAQMX they will be asked to select their default message 
  561. areas to read, the message packing method and transfer protocol to be used.  
  562. Message area selection must be done before the caller can "Pack for Download".
  563. Unconfigured (new) users are not given the option to download messages UNTIL 
  564. they have completed their configuration.
  565.  
  566. ┌─────────────────────────────────────────────────────────────────────────────┐
  567. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 12  ▒▒▒ │
  568. └─────────────────────────────────────────────────────────────────────────────┘
  569.  
  570.  
  571. When selecting message areas the first time, your users should select from 
  572. "All" groups instead of only those which have new messages!  This will allow 
  573. them to select from all available groups and save these defaults for use every
  574. time until they change them (and not miss any areas that do not have "new"
  575. messages available at the current time).
  576.  
  577. The users SECURITY level and AUTHORIZATION flags determine the areas from 
  578. which they can select messages.  If a message area has a higher security level 
  579. on EITHER read OR WRITE, they will be unable to select or read the area.  
  580. Please make sure you understand the last sentence!  The user must be able to 
  581. both read =AND= write to an area or it will not be available.  The ability to 
  582. READ but NOT write will NOT get the user the area!  The user must also have 
  583. any authorization flags that you have assigned to an area. 
  584.  
  585. The number of messages XRS can handle in one "MailBag" is 995, so that is
  586. also the maximum number of messages RAQMX will extract before beginning the
  587. archiving process - normally, a caller will probably get much less mail than 
  588. that!  RAQMX will normally default to a message number that gives the LAST 20% 
  589. of the messages FOR A FIRST TIME USER.  This prevents a first time caller from 
  590. accidentally downloading a packet of ALL the messages!  As Sysop, you can set 
  591. the maximum limit lower than 995 by using the LIMIT option in your 
  592. QMXSETUP.CFG file. 
  593.  
  594. Note that RAQMX (and the XRS reader/editor) do not do "exact" matching as far
  595. as upper/lower case letters go!  You will always get all messages addressed
  596. to you no matter how the names are capitalized by the sending system!
  597.  
  598. Unless instructed not to, RAQMX will =ALWAYS= automatically extract =ALL= mail 
  599. addressed to the caller whether or not they have the message's group selected. 
  600. That way, the caller can be assured that they won't miss any mail even if they 
  601. don't regularly read certain conferences.  This function can be defeated by 
  602. selecting an option in the RAQMX configuration section.  The user may elect to 
  603. tell RAQMX =NOT= to scan for messages OUTSIDE the selected areas.  This 
  604. change is useful if the user calls several boards and doesn't want to receive 
  605. duplicates of the same messages from each board. 
  606.  
  607. RAQMX will NOT extract messages FROM the caller since it assumes they have 
  608. seen them before!  Your user CAN include their own messages by selecting that 
  609. option in the CONFIGURATION menu. 
  610.  
  611. RAQMX allows a caller to select message areas that have PRIVATE messages.  
  612. When scanning these areas, it will =ONLY= pack mail addressed TO THE CALLER 
  613. OR MARKED "Public".  Private mail to other individuals is NOT included in the 
  614. mailbag.
  615.  
  616. RAQMX will normally ask if you wish to update the HighMsgRead and/or 
  617. LASTREAD.BBS fields, assuming you read new message (you can select "Pack" from 
  618. the main menu and "backtrack" to old messages!).  You should, in general, 
  619. always answer "Yes"!  If your user selects the <L>ogoff option, when packing 
  620. mail, then the HighMessageRead and LastRead fields are updated automatically. 
  621.  
  622. ┌─────────────────────────────────────────────────────────────────────────────┐
  623. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 13  ▒▒▒ │
  624. └─────────────────────────────────────────────────────────────────────────────┘
  625.  
  626. You will want to make the XRS eXpress Response Reader available to your 
  627. callers.  The Reader comes with it's own documentation included in the 
  628. package.  Again, there are two versions.  One for XT type machines and
  629. one for AT systems.  Current versions are XRS32EXE.ZIP (generic 8088/8086)
  630. and XRS32EX!.ZIP - the V20/30/80286/386 edition. Overlay versions are also 
  631. available as XRS32OV.ZIP and XRS32OV!.ZIP.  Overlay versions require less 
  632. memory but will not run as quickly on slower machines.  XRS32COR.ZIP provides 
  633. the documentation AND other files needed for ALL versions and =IS REQUIRED= to 
  634. use XRS.  XRS32KIT.ZIP provides sample scripts for various communications 
  635. programs plus Dutch native-language support overlays and is optional. 
  636.  
  637.  
  638.                          ┌───────────────────────┐
  639.                          │ ▒▒▒  Odds & Ends  ▒▒▒ │
  640.                          └───────────────────────┘
  641.  
  642.  
  643. RAQMX operates as a pseudo-point system.  The callers "point" number is 
  644. determined by RAQMX the first time the user selects any options in the 
  645. configuration menu of RAQMX.  The user will be assigned the next consecutive 
  646. number above the last assigned RAQMX user.  The information that RAQMX needs 
  647. for each user is kept in a small file named QMX_CONF.SYS.  Since RAQMX 
  648. maintains its own data file, you can sort and pack your userlog at any time 
  649. without any effect on RAQMX. 
  650.  
  651. A small program (QMX_STAT) is included in your package.  This program allows 
  652. you to list your point users and their assigned numbers, with statistics.
  653. RAQMX also places information about how many messages are downloaded, mailbags
  654. received, groups selected and other information in your LOG file.
  655.  
  656. As a point of information, XRS uses 30027/xxx as the "From" address in the 
  657. outbound message bundles.  This has NO effect on your systems actual node 
  658. number and can be ignored!  ('xxx' always = 0 if running "No Point" mode)
  659. Be sure to add "PointNet 30027" to your echomail processor's configuration
  660. file if you run in 'secure' mode!  This pseudo "PointNet" number was (and
  661. other pointnet numbers are) assigned by the Zone Coordinator.
  662.  
  663. RAQMX watches the users input and features an automatic user entry timeout set 
  664. at three minutes.  This is integrated in the FOSSIL input routines.  After two 
  665. minutes with no activity, the program will beep three times signaling that it 
  666. is waiting for input.  If another full minute elapses without any response, 
  667. the program is terminated. 
  668.  
  669. RAQMX looks for the file named "EXPRESS.BBS" and copies it into the top of 
  670. SUMMARY1.XRS each time the program is run.  This allows you to have a custom 
  671. BBS "banner" of special message that will pop up in the users' editor <F6> 
  672. summary/index window every time!  You should not use color graphics in this 
  673. file, since the summary/index routine pokes characters into memory for speed
  674. and therefore does not allow for ANSI interpretation...   This allows you to
  675. have a special announcement capability for RAQMX/XRS users.  You could place
  676. notices of new versions being available in there, as well.
  677.  
  678. ┌─────────────────────────────────────────────────────────────────────────────┐
  679. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 14  ▒▒▒ │
  680. └─────────────────────────────────────────────────────────────────────────────┘
  681.  
  682.  
  683. A short 'PROMO' file is included, for your use, to announce the addition of 
  684. RemoteAccess/QuickBBS Message eXpress to your system.  You'll find it included 
  685. as BULLETIN.ASC, should you want to use it in your 'NEWS.ASC' or 
  686. 'BULLETIN.ASC' files. 
  687.  
  688. We think you going to like this new way for your callers to communicate with 
  689. your system!  It allows your best and most active users to get on, get their 
  690. mail and get off in much less time.
  691.  
  692. If you have questions, suggestions or problems, we'll be happy to try and 
  693. help. 
  694.  
  695. A FidoNet "EchoMail" conference with AREA: tag "QMX_XRS" is available from
  696. the echomail "backbone" system.  You'll find lots of friendly help and lively 
  697. discussion of topics of interest to RAQMX SysOps in this conference.  You 
  698. should be able to get connected easily via your local Network Echo 
  699. Coordinator! 
  700.  
  701. Note: native Dutch message & help overlays for XRS (Peter and friends) and 
  702. Dutch language documentation by Rudi Kusters is available, making XRS truly 
  703. bi-lingual. French, German and Swedish are also available.  If you need one 
  704. of these for XRS, Contact Mike Ratledge for further details. 
  705.  
  706. ┌─────────────────────────────────────────────────────────────────────────────┐
  707. │ ▒▒▒   RAQMX    ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒   PAGE 15  ▒▒▒ │
  708. └─────────────────────────────────────────────────────────────────────────────┘
  709.  
  710.                             ┌───────────────────┐
  711.                             │ ▒▒▒  Credits  ▒▒▒ │
  712.                             └───────────────────┘
  713.  
  714.  
  715.  
  716. Documentation for RemoteAccess/QuickBBS Mail eXpress module written by: 
  717. Ed Meloan, SysOp of The Augusta Forum RemoteAccess system (360/0, 360/1)
  718. and Michael Y. Ratledge and dated June 1, 1990
  719.  
  720.  
  721.  
  722. The first page graphics and page heading ideas were "stolen" from
  723. Mike Janke's outstanding program RACE!  I am deeply appreciative
  724. of his allowing me to use them to dress up the RAQMX documentation.
  725.  
  726.  
  727.  
  728. (C) CopyRight 1990 by Michael Y. Ratledge, CDP, CSP
  729. SysOp of East Bay X-Change Multi-Node TCommNet BBS in Charleston, SC, USA
  730. FidoNet addresses: 1/112, 1/318, 372/0, 372/555, 372/666, 372/777, 372/888
  731. Compuserve Information System ID: 76666/1512
  732.  
  733.